作業員のインポート/エクスポート
作業員データをインポートおよびエクスポートするための、2つのRESTサービスがあります。
作業員のインポート
入力パラメータ:
- Operators.ZIP
- サイト名
Operators.ZIP には1つまたは複数のフォルダーを含めることができます。各フォルダーには次が必要です:
- OperatorId.json ファイル
- 作業員のすべてのトレーニング済み単語が含まれている音声テンプレートZIP ファイル
1人の作業員をインポートする場合、operatorIdが唯一の必要なパラメータです。複数の作業員をインポートする場合、パラメータは必要ありません。
RESTを使って、新規作業員と既存作業員のどちらも作成することができます。
応答コード
200 OK: すべての作業員のインポートが成功
400 Bad Request: ZIPファイルの内容が無効
207 Multi-Status: 一部の作業員がインポートされ、一部はインポートされなかった。エラーメッセージにはインポートされなかったすべての作業員の情報が含まれます。
作業員のエクスポート
URL (1人の作業員): http://serverip:port/VoiceCheck/services/operator/{operatorId}
ここで、operatorId は作業員のログイン名です。たとえば、作業員 tsmith の場合次のようになります：http://serverip:port/VoiceCheck/services/operator/{tsmith}
URL (すべての作業員):http://serverip:port/VoiceCheck/services/operators/
すべての作業員ではなく複数の作業員をエクスポートしたい場合、1人の作業員をエクスポートするRESTサービスを n 回呼び出します。
メソッド: (GET), Content Type (application/json;charset=UTF-8)
応答
成功: HTTP Status 200 （ボディありまたはなし）
失敗: システムがエラーを返します
結果: 作業員データを含む zip ファイル。
ファイルのインポート/エクスポートの内容と形式
ファイルはZIP形式でなくてはなりません。 ZIPファイルには作業員と同じ数のフォルダーが含まれます。たとえば、5人の作業員をインポートまたはエクスポートする場合、ZIPファイルには各作業員ごとに5つのフォルダーが含まれることになります。
各フォルダーには次が含まれます：
- operator.json ファイル: このファイルには作業員ID、名前、電子メールならびに暗号化されたパスワードおよびアクセスコードを含む作業員の情報が含まれます。例：ben.json
- その作業員に対するすべてのテンプレートを含むZIPファイル。 このZIPファイルの名前は"operatorID_templates.zip"です（例：ben_templates.zip）。
- このZIPファイルには.bt2ファイルが含まれます。これらは作業員のテンプレートファイルです。
- .bt2 ファイルの名前の形式は"Language_operator_vocab.bt2" （例： %en-US%_ben_alpha.bt2）です。